home *** CD-ROM | disk | FTP | other *** search
/ Software Vault: The Gold Collection / Software Vault - The Gold Collection (American Databankers) (1993).ISO / cdr25 / view3d.zip / VIEW3D.HLP (.txt) < prev   
OS/2 Help File  |  1993-06-06  |  13KB  |  352 lines
  1.  
  2. ΓòÉΓòÉΓòÉ 1. General Help ΓòÉΓòÉΓòÉ
  3.  
  4.     This is a 32-bit, mouse oriented, interactive 3-dimensional (3-D) data 
  5. viewing program for the IBM OS/2 2.x operating system. The program has the mini 
  6. Virtual Reality (VR) capability that enables the use to interact with the 3-D 
  7. data easily. Future versions will make use of OS/2's mutithread capabilities to 
  8. render the use of system facilities more efficient. 
  9.  
  10.  
  11. ΓòÉΓòÉΓòÉ 2. Help Index ΓòÉΓòÉΓòÉ
  12.  
  13. Each of the enabled functions is described. 
  14.  
  15.  
  16. ΓòÉΓòÉΓòÉ 2.1. File ΓòÉΓòÉΓòÉ
  17.  
  18.  
  19. ΓòÉΓòÉΓòÉ 2.1.1. Exit ΓòÉΓòÉΓòÉ
  20.  
  21. Exit the program. 
  22.  
  23.  
  24. ΓòÉΓòÉΓòÉ 2.1.2. About ΓòÉΓòÉΓòÉ
  25.  
  26. Display the product information. 
  27.  
  28.  
  29. ΓòÉΓòÉΓòÉ 2.2. Edit ΓòÉΓòÉΓòÉ
  30.  
  31.  
  32. ΓòÉΓòÉΓòÉ 2.2.1. Cut ΓòÉΓòÉΓòÉ
  33.  
  34. Cut a rectangular out of the image(s) and redisplay it's (their) part(s) inside 
  35. the rectangular. At present, this function serves no purpose other than 
  36. testing. 
  37.  
  38.  
  39. ΓòÉΓòÉΓòÉ 2.3. 3-D Models ΓòÉΓòÉΓòÉ
  40.  
  41. Define, Lable, Build and Destroy the 3-D model(s). 
  42.  
  43.  
  44. ΓòÉΓòÉΓòÉ 2.3.1. Demos ΓòÉΓòÉΓòÉ
  45.  
  46. A set of 7 analytic functions that can generate the 3-D data set used for 
  47. demonstration. 
  48.  
  49. Γûá Function 1: x = 12*u, y = 12*v, z = 0.
  50. Γûá Function 2: x = 12*cos(v), y = 12*sin(v), z = 12*u/Pi.
  51. Γûá Function 3: x = 12*cos(v)*sin(u), y = 12*sin(v)*sin(u), z = 12*cos(u).
  52. Γûá Function 4: x = 3*cos(v)*(5-1.2*sin(u)), y = 3*sin(v)*(5-1.2*sin(u)), z = 3*(1.2*cos(u)+sin(4*v)).
  53. Γûá Function 5: x = 12*v*cos(v)*cos(u), y = 12*v*sin(v)*cos(u), z = 12*v*sin(u).
  54. Γûá Function 6: x = 12*(Pi/2+atan(10*(u-Pi/1.7)))*cos(v), y = 12*(Pi/2+atan(10*(u-Pi/1.7)))*sin(v), z = 12*u.
  55. Γûá Function 7: x = 12*u, y = 12*v, z = 12*Pi*sin(0.85*(u^2+v^2)).
  56.  
  57.  
  58. ΓòÉΓòÉΓòÉ 2.3.2. ASCII Input ΓòÉΓòÉΓòÉ
  59.  
  60.   The format of these script files in the current version of the program is 
  61. ---------------------------------------------------------------------- 
  62. id: #        | A non-negative integer id number. (0<= id < 30) 
  63. ---------------------------------------------------------------------- 
  64. Name: name      | A string that labels a particular data set. 
  65. ---------------------------------------------------------------------- 
  66. Color:        | A string that declares the color of the covering 
  67.           | surface of the image. The availble colors are: 
  68.           | Blue, DarkBlue, Green, DarkGreen, Red, DarkRed, 
  69.           | Yellow, Cyan, Pink, DarkPink, White, Black, 
  70.           | Brown, DarkGray, PaleGray 
  71. ---------------------------------------------------------------------- 
  72. nu nv        | nu is the number of mesh points on the u-axis and nv is 
  73.           | the number of mesh points on the v-axis. 
  74. ---------------------------------------------------------------------- 
  75. x1 y1 z1       | This set is the 3-D data block. The order of these 
  76. x2 y2 z2       | 3-D data points are arranged such that the u 
  77.  ....        | parameter is kept fixed while v run from v_1 to 
  78.  ....        | v_nv, then u changes to its next value and v run 
  79. xn yn zn       | from v_1 to v_nv again. 
  80. ---------------------------------------------------------------------- 
  81. Coordinate      | A string that signifies the begining of the body 
  82.           | coordinate definition. 
  83. ---------------------------------------------------------------------- 
  84. xx0 xy0 xz0     | Two points that define the x_axis. It can be set 
  85. xx1 xy1 xz1     | to {0 0 0} and {a 0 0} at the begining, with "a" 
  86.           | a number of the same order as the size of the 3-D 
  87.           | object. 
  88. ---------------------------------------------------------------------- 
  89. yx0 yy0 yz0     | Two points that define the y_axis. It can be set 
  90. yx1 yy1 yz1     | to {0 0 0} and {0 a 0} at the begining. "a" 
  91.           | should be the same as the one for the x_axis. 
  92. ---------------------------------------------------------------------- 
  93. zx0 zy0 zz0     | Two points that define the z_axis. It can be set 
  94. zx1 zy1 zz1     | to {0 0 0} and {0 0 a} at the begining. "a" 
  95.           | should be the same as the one for the x_axis. 
  96. ---------------------------------------------------------------------- 
  97. next/end       | A string signifies the termination of the data 
  98.           | set definition. If the string is "next", it also 
  99.           | signifies the begin of a next one. Otherwise, it 
  100.           | signifies the end of the definition. 
  101. ---------------------------------------------------------------------- 
  102.  .....        | Repeate the above steps, if a "next" is read, to 
  103.  .....        | define another 3-D object to be plotted on the 
  104.  .....        | same screen. 
  105. ---------------------------------------------------------------------- 
  106.  
  107.  
  108. ΓòÉΓòÉΓòÉ 2.3.3. ASCII Output ΓòÉΓòÉΓòÉ
  109.  
  110.  It saves all of the 3-D objects in the current session. 
  111.  
  112.  
  113. ΓòÉΓòÉΓòÉ 2.3.4. Select Models ΓòÉΓòÉΓòÉ
  114.  
  115.  By clicking on the image(s) under the mouse pointer using the mouse button 1, 
  116. the mode of the image(s) selected can be changed. 
  117.  
  118.  
  119. ΓòÉΓòÉΓòÉ 2.3.5. Select All ΓòÉΓòÉΓòÉ
  120.  
  121.  If not all of the images are in the active mode, it turns all of them active. 
  122.  
  123.  
  124. ΓòÉΓòÉΓòÉ 2.3.6. Display All ΓòÉΓòÉΓòÉ
  125.  
  126.  If not all of the images defined are displayed, it displays all of them on the 
  127. screen. 
  128.  
  129.  
  130. ΓòÉΓòÉΓòÉ 2.3.7. Destory Active ΓòÉΓòÉΓòÉ
  131.  
  132.  Destory all of the images that are in the active mode. Since the memory spaces 
  133. allocated for these images are also released, these images can not be recovered 
  134. after this action. 
  135.  
  136.  
  137. ΓòÉΓòÉΓòÉ 2.3.8. Destory All ΓòÉΓòÉΓòÉ
  138.  
  139.  Destory all images in the current session. Since the memory spaces allocated 
  140. for these images are also released, these images can not be recovered after 
  141. this action. 
  142.  
  143.  
  144. ΓòÉΓòÉΓòÉ 2.4. Action ΓòÉΓòÉΓòÉ
  145.  
  146.  Viewer's motion and action. 
  147.  
  148.  
  149. ΓòÉΓòÉΓòÉ 2.4.1. Construction ΓòÉΓòÉΓòÉ
  150.  
  151.     Reconstruct the images using the current parameters. 
  152.  
  153.  
  154. ΓòÉΓòÉΓòÉ 2.4.2. Transformation ΓòÉΓòÉΓòÉ
  155.  
  156.   The viewer can rotate, displace, scale or delete individual or a group of 3-D 
  157. object(s) when it (they) is (are) active. To perform these transformations, the 
  158. viewer should first activate the object(s) by turning on the "Select Models" 
  159. mode, which can be activated in the "3D Models" menu, and clicking on object(s) 
  160. that is (are) not active and is (are) of interest. (If the object is already 
  161. active before been clicked, it turns the object into inactive mode after been 
  162. clicked.) By selecting the "Transform" item in "Action" menu, providing the 
  163. required parameters and turning on the transformation buttons, the viewer can 
  164. achieve the intended transformation(s).  The order or the transformations 
  165. applied is the same as the one appears on the dialog box. 
  166.  
  167.  
  168. ΓòÉΓòÉΓòÉ 2.4.3. Shift Focus ΓòÉΓòÉΓòÉ
  169.  
  170.   The viewer can shift his/her focus (of viewing). The focus point of the 
  171. viewer on the screen is assumed to be at the center. To shift the focus point, 
  172. the viewer should activate the shift focus mode in the "Action" menu. By 
  173. pointing the mouse pointer to the point of interest and clicking the mouse 
  174. button 1, the effects of shifting focus point in the real life can be achieved. 
  175. This mode is automatically deactivated when the program finishes the shifting 
  176. focus process. 
  177.  
  178.  
  179. ΓòÉΓòÉΓòÉ 2.4.4. Walk Stopped ΓòÉΓòÉΓòÉ
  180.  
  181.   The viewer can walk forward and backward in his/her focus direction of 
  182. viewing. This mode can be activated in the "Action" menu by clicking on the 
  183. "Walk Stoped" item. Once the walking mode is activated, the "Walk Stoped" item 
  184. is changed to "Walking..." indicating that the viewer is in walking mode. The 
  185. viewer walk forward if he/she clicks the mouse button 1 and walk backward if 
  186. he/she clicks the mouse button 2. This mode is deactivated by clicking the 
  187. mouse button 3  or pressing the ESC key in case the viewer has a two button 
  188. mouse or prefers to do so. 
  189.  
  190.  
  191. ΓòÉΓòÉΓòÉ 2.4.5. Mini VR ΓòÉΓòÉΓòÉ
  192.  
  193.   The viewer can "fly" through and around the 3-D objects in real time. This is 
  194. a mini virtual reality (VR) mode in which the viewer can look around at all 
  195. directions and move to anywhere in the virtual 3-D space. This mode is 
  196. activated in the "Action" menu. After activation of this mode, the viewer moves 
  197. to the right by moving the mouse to the right and he/she moves to the left by 
  198. moving the mouse to the left. To move upward, the viewer should move the mouse 
  199. forward (this is just opposite to the conventional airplane). Opposite 
  200. direction of motion is achieved by moving the mouse backward. The speed of the 
  201. foward flying is controled by the frequence of the mouse button 1 been clicked. 
  202. The speed of the backward flying speed is controled by the frequency of the 
  203. mouse button 2 been clicked. This mode is deactivated by pressing the mouse 
  204. button 3 or the ESC key in case the viewer has a two button mouse or prefers to 
  205. do so. 
  206.  
  207.  
  208. ΓòÉΓòÉΓòÉ 2.5. View ΓòÉΓòÉΓòÉ
  209.  
  210.  Viewer's choice on how the images should be viewed. 
  211.  
  212.  
  213. ΓòÉΓòÉΓòÉ 2.5.1. Redraw ΓòÉΓòÉΓòÉ
  214.  
  215.   It redraws all of the images in the current session. 
  216.  
  217.  
  218. ΓòÉΓòÉΓòÉ 2.5.2. Draw ΓòÉΓòÉΓòÉ
  219.  
  220.   It contains various choices for the viewer to draw different aspects of the 
  221. images. 
  222.  
  223.  Visual Bound 
  224.  
  225. ?????. 
  226.  
  227.  2-D Images Mesh 
  228.  
  229.   It displays a rectangular mesh that covers each image. 
  230.  
  231.  Wire Frame 
  232.  
  233.   It displays the wire frame of a 3-D object. 
  234.  
  235.  Cover Surface 
  236.  
  237.   It displays the covering surfaces of a 3-D object. 
  238.  
  239.  Body Coord 
  240.  
  241.   It displays the body coordinate axis for each 3-D object. 
  242.  
  243.  World Coord 
  244.  
  245.   It displays the world coordinate axis. 
  246.  
  247.  
  248. ΓòÉΓòÉΓòÉ 2.5.3. Options ΓòÉΓòÉΓòÉ
  249.  
  250.   It provides the viewer with various ways of displaying the images of 3-D 
  251. objects. 
  252.  
  253.  World Coordinate 
  254.  
  255.   If this item is checked, a world coordinate is displayed. The world 
  256. coordinate provides a mean for the viewer to keep track of his/her orientation 
  257. when "traveling" in the virtual 3-D space. 
  258.  
  259.  Body Coordinate 
  260.  
  261.   This item acts on each images separately. Each image on the screen contains a 
  262. flag indicating whether or not to display its body coordinate. If the viewer 
  263. wants to change this flag, he/she should first activate those images that the 
  264. change is intended to be performed and deactivate those ones that no change is 
  265. intended for them. 
  266.  
  267.  Bounding Wire Box 
  268.  
  269.   This item acts on each images separately. Each image on the screen contains a 
  270. flag indicating whether or not to display the wire frame of its bounding box. 
  271. If the viewer wants to change this flag, he/she should first activate those 
  272. images that the change is intended to be performed and deactivate those ones 
  273. that no change is intended for them. 
  274.  
  275.  Numerical Coord.. 
  276.  
  277.   This item acts on each images separately. Each image on the screen contains a 
  278. flag indicating whether or not to display numerical coordinate in the world 
  279. coordinate. If the viewer wants to change this flag, he/she should first 
  280. activate those images that the change is intended to be performed and 
  281. deactivate those ones that no change is intended for them. 
  282.  
  283.  Solid Coordinate 
  284.  
  285.   This item acts on each images separately. Each image on the screen contains a 
  286. flag indicating whether or not to display the solid surfaces of its bounding 
  287. box that does not block the view of the 3-D object. If the viewer wants to 
  288. change this flag, he/she should first activate those images that the change is 
  289. intended to be performed and deactivate those ones that no change is intended 
  290. for them. 
  291.  
  292.  Hide Hidden Lines 
  293.  
  294.   This item acts on each images separately. Each image on the screen contains a 
  295. flag indicating whether or not to remove the hidden lines of the image of the 
  296. 3-D object. If the viewer wants to change this flag, he/she should first 
  297. activate those images that the change is intended to be performed and 
  298. deactivate those ones that no change is intended for them. 
  299.  
  300.  Covering Surfaces 
  301.  
  302.   This item acts on each images separately. Each image on the screen contains a 
  303. flag indicating whether or not to remove the hidden surfaces of the image of 
  304. the 3-D object. If the viewer wants to change this flag, he/she should first 
  305. activate those images that the change is intended to be performed and 
  306. deactivate those ones that no change is intended for them. 
  307.  
  308.  Box Clipping 
  309.  
  310.   If checked, the images are clipped by a rectangular box. Outside the box, no 
  311. images are displayed. 
  312.  
  313.  Sound 
  314.  
  315.  It turns on/off the sound effects. 
  316.  
  317.  
  318. ΓòÉΓòÉΓòÉ 2.5.4. Zoom ΓòÉΓòÉΓòÉ
  319.  
  320.  Zooming options. 
  321.  
  322.  Screen Zoom 
  323.  
  324.  This is a simple screen zooming. 
  325.  
  326.  Telescope 
  327.  
  328.  The viewer can adjust his/her open viewing angle to simulate the effects of a 
  329. telescope. This mode can be activated in the "Zoom" submenu of the "View" menu. 
  330. After activating this mode, the viewer can zoom-in by clicking the mouse button 
  331. 1 and zoom-out by clicking mouse button 2. To deactivate the zooming mode, the 
  332. viewer should click the mouse button 3 or press the ESC key in case he/she has 
  333. a two button mouse or prefers to do so. 
  334.  
  335.  
  336. ΓòÉΓòÉΓòÉ 2.6. Parameters ΓòÉΓòÉΓòÉ
  337.  
  338.   It provides the viewer to change various parameters. 
  339.  
  340.  
  341. ΓòÉΓòÉΓòÉ 2.6.1. Transform ΓòÉΓòÉΓòÉ
  342.  
  343.   It provides the parameters for transformations, which are limited to three 
  344. kind: translation, rotation and scaling. 
  345.  
  346.  
  347. ΓòÉΓòÉΓòÉ 2.6.2. Eye and Screen ΓòÉΓòÉΓòÉ
  348.  
  349.   It provides the input for the viewing eye's open angle, it's polar angle in 
  350. the world coordinate, and it's distance from the origin of the world 
  351. coordinate. After providing relevant parameters, the images of the 3-D objects 
  352. that are seen in current location of the viewer are displayed.